home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / pc / SNNSV32.ZIP / SNNSv3.2 / tools / doc / m_art.doc < prev    next >
Encoding:
Text File  |  1994-04-25  |  10.3 KB  |  358 lines
  1. ==============================================================================
  2. Description of the tool M_ART
  3. ==============================================================================
  4.  
  5.  
  6.                                   MAKEART
  7.  
  8.              Copyright (c) 1990-1993  SNNS Group, IPVR, Univ. Stuttgart, FRG
  9.  
  10.  
  11.  
  12.  
  13.  
  14. ==============================================================================
  15. TABLE OF CONTENTS  /   INHALTSVERZEICHNIS
  16.         English documentation  .......................  line    25
  17.         Deutsche Dokumentation .......................  Zeile  200
  18. ==============================================================================
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25. ==============================================================================
  26.                          English documentation
  27. ==============================================================================
  28.         A TOOL TO GENERATE ART-NETWORKS AS THEY ARE NEEDED FOR
  29.  
  30.                          SNNS ART ALGORITHMS
  31.  
  32.  
  33.                     written by:   Kai-Uwe Herrmann
  34.  
  35.  
  36. ------------------------------------------------------------------------------
  37. Preliminary remarks on the documentation
  38. ------------------------------------------------------------------------------
  39.  
  40. Using the SNNS ART algorithms, it is rather boring to create the
  41. corresponding networks using the graphical user interface.
  42. The reason is that we need many different unit types with different
  43. activation functions, different sites etc.
  44.  
  45. So M_ART (MAKEART) is a tool doing this boring job for you. It is
  46. distributed with the SNNS (Stuttgart Neural Network Simulator) and
  47. is a stand-alone-software using the kernel of SNNS.
  48.  
  49.  
  50.  
  51. ------------------------------------------------------------------------------
  52. Further Reading
  53. ------------------------------------------------------------------------------
  54.  
  55. To get an idea of the realization, implementation of the ART algorithms
  56. (ART1, ART2 and ARTMAP) in SNNS it will be necessary to read
  57.  
  58. [1] Kai-Uwe Herrmann: "ART-Adaptive Resonance Theory, Architekturen,
  59.                        Implementierung und Anwendung";
  60.                        Diplomarbeit Nr.929;
  61.                        Institut fuer Parallele und Verteilte
  62.                        Hoechstleistungsrechner;
  63.                        Fakultaet Informatik;
  64.                        Universitaet Stuttgart; 1992
  65.  
  66. A PostScript-File of [1] should be available with SNNS via FTP.
  67.  
  68.  
  69.  
  70. ------------------------------------------------------------------------------
  71. Files
  72. ------------------------------------------------------------------------------
  73.  
  74. MAKEART consists of the following source files:
  75.  
  76.       m_art.doc
  77.       m_art.c
  78.       m_art1.c
  79.       m_art1.h
  80.       m_art2.c
  81.       m_art2.h
  82.       m_artmap.c
  83.       m_artmap.h
  84.  
  85. It is written in C, following the ANSI C standard.
  86.  
  87.  
  88. ------------------------------------------------------------------------------
  89. Using MAKEART
  90. ------------------------------------------------------------------------------
  91.  
  92.  
  93. Calling MAKEART
  94. ===============
  95.  
  96. To start MAKEART enter
  97.  
  98.       %m_art
  99.  
  100. on a unix-shell.
  101.  
  102.  
  103. The following text will appear on screen:
  104.  
  105.    ------ Network Generator for ART Network architectures ------
  106.  
  107.    using: SNNS 3D-Kernel V2.2        (<<<<<<<<< or which version you ever use)
  108.  
  109.    Choose the ART model:
  110.  
  111.        1 ....... ART 1
  112.        2 ....... ARTMAP
  113.        3 ....... ART 2
  114.  
  115.       99 ....... Quit
  116.  
  117.  
  118.     Enter number:
  119.  
  120. Enter either 1, 2, 3 or 99. Depending on the choice you made, you will
  121. now have to enter several parameters for the creation of the network or
  122. leave MAKEART.
  123.  
  124. If you chose 1 or 3, you will first be prompted for the number of units
  125. in the F1 Layer. Let's call this number N.
  126. Afterwards you will be asked for the number of rows the N F1 units should
  127. build.
  128.  
  129. Examples:  N=10   no. of rows = 3  will create a F1 layer as follows:
  130.  
  131.                O O O O
  132.                O O O
  133.                O O O
  134.  
  135.           where each  O  represents a unit.
  136.  
  137.           N=10   no. of rows = 4  will create
  138.  
  139.                O O O
  140.                O O O
  141.                O O
  142.                O O
  143.  
  144. So with the parameter 'no. of rows', you will be able to tell MAKEART
  145. how you wish the units to appear in the DISPLAY.
  146. The same procedure as for F1 is to be done for the F2 layer. You will
  147. be prompted for the number of units in F2 (M) and again the corresponding
  148. number of rows.
  149.  
  150. After entering the required 4 parameters:
  151.  
  152.          number of units in F1,
  153.          number of rows in F1,
  154.          number of units in F2,
  155.          number of rows in F2
  156.  
  157. the network will be generated. Finally you will be prompted for
  158. the name of the network and the filename. The network will then
  159. be saved in a file with the filename you gave. The fileformat is
  160. the standard SNNS netfile format.
  161.  
  162.  
  163. If you chose 2 instead of 1 or 3, things will be slightly different.
  164. For an ARTMAP network you have to define eight parameters, because
  165. it consists of 2 ART1 networks. So you have to define the above
  166. four parameters for ARTa and ARTb:
  167.  
  168.          number of units in F1a,
  169.          number of rows in F1a,
  170.          number of units in F2a,
  171.          number of rows in F2a,
  172.          number of units in F1b,
  173.          number of rows in F1b,
  174.          number of units in F2b,
  175.          number of rows in F2b.
  176.  
  177.  
  178. Choice 99 will lead you back to the unix prompt.
  179. ==============================================================================
  180.                    End of English documentation
  181. ==============================================================================
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200. ==============================================================================
  201.                         Deutsche Dokumentation
  202. ==============================================================================
  203.  
  204.          EIN WERKZEUG, UM ART-NETZWERKE ZU GENERIEREN, WIE SIE
  205.  
  206.              FUER DIE SNNS-ART-ALGORITHMEN BENOETIGT WERDEN
  207.  
  208.                          von:   Kai-Uwe Herrmann
  209.  
  210.  
  211. ------------------------------------------------------------------------------
  212. Vorbemerkungen
  213. ------------------------------------------------------------------------------
  214.  
  215. ART-Netzwerke fuer die SNNS-ART-Algorithmen mit der graphischen
  216. Oberflaeche XGUI direkt zu erzeugen ist sehr ermuedend, da sehr
  217. viele verschiedene Unit-Typen mit vielen verschiednen Aktivierungs-
  218. funktion und Sites gebraucht werden. Auch die Verbindungsstruktur
  219. ist sehr inhomogen.
  220.  
  221. Deshalb wurde MAKEART entwickelt, um diese laestige Arbeit zu
  222. uebernehmen. MAKEART wird mit dem SNNS (Stuttgarter Neuronale Netze Simulator)
  223. geliefert. Es ist ein eigenes Programm, das den SNNS-Kern verwendet.
  224.  
  225.  
  226. ------------------------------------------------------------------------------
  227. Weitere Literatur
  228. ------------------------------------------------------------------------------
  229.  
  230. Um zu erfahren, wie die ART-Algorithmen (ART1, ART2 und ARTMAP) in SNNS
  231. realisiert und implementiert sind, ist folgende Lektuere notwendig:
  232.  
  233. [1] Kai-Uwe Herrmann: "ART-Adaptive Resonance Theory, Architekturen,
  234.                        Implementierung und Anwendung";
  235.                        Diplomarbeit Nr.929;
  236.                        Institut fuer Parallele und Verteilte
  237.                        Hoechstleistungsrechner;
  238.                        Fakultaet Informatik;
  239.                        Universitaet Stuttgart; 1992
  240.  
  241. Ein PostScript-File von [1] sollte mit SNNS via FTP erhaeltlich sein.
  242.  
  243.  
  244.  
  245. ------------------------------------------------------------------------------
  246. Dateien
  247. ------------------------------------------------------------------------------
  248.  
  249. MAKEART besteht aus den folgenden Dateien:
  250.  
  251.       m_art.doc
  252.       m_art.c
  253.       m_art1.c
  254.       m_art1.h
  255.       m_art2.c
  256.       m_art2.h
  257.       m_artmap.c
  258.       m_artmap.h
  259.  
  260. Es ist in C geschrieben, dem ANSI-C-Standard folgend.
  261.  
  262.  
  263.  
  264. ------------------------------------------------------------------------------
  265. Benutzung von MAKEART
  266. ------------------------------------------------------------------------------
  267.  
  268.  
  269. Um MAKEART aufzurufen geben Sie
  270.  
  271.       %m_art
  272.  
  273. in einer Unix-Shell ein.
  274.  
  275.  
  276. Daraufhin wird folgender Text auf dem Bildschirm erscheinen:
  277.  
  278.    ------ Network Generator for ART Network architectures ------
  279.  
  280.    using: SNNS 3D-Kernel V2.2         (<<<<<<<<< oder welche Version auch immer)
  281.  
  282.    Choose the ART model:
  283.  
  284.        1 ....... ART 1
  285.        2 ....... ARTMAP
  286.        3 ....... ART 2
  287.  
  288.       99 ....... Quit
  289.  
  290.  
  291.     Enter number:
  292.  
  293. Geben Sie entweder 1, 2, 3 oder 99 ein. Abhaengig von der getroffenen
  294. Wahl, muessen jetzt verschiedene Parameter fuer die Generierung des
  295. Netzes eingegeben werden, oder Sie verlassen MAKEART.
  296.  
  297. Haben Sie 1 oder 3 gewaehlt, dann werden Sie zunaechst nach der Zahl
  298. der Units in der F1-Schicht gefragt. Wir nennen diese Zahl N.
  299. Danach werden Sie nach der Zahl der Zeilen gefragt, die diese N F1 units
  300. bilden sollen.
  301.  
  302. Beispiele: N=10   Zeilenzahl = 3  wird eine F1-Schicht generieren, die so
  303.            aussieht:
  304.  
  305.                O O O O
  306.                O O O
  307.                O O O
  308.  
  309.            Dabei repraesentiert jedes  O  ein Unit.
  310.  
  311.            N=10   Zeilenzahl = 4  generiert:
  312.  
  313.                O O O
  314.                O O O
  315.                O O
  316.                O O
  317.  
  318. Mit der Zeilenzahl sind sie also in der Lage, MAKEART mitzuteilen, wie
  319. die jeweilige Schicht im DISPLAY von SNNS aussehen soll.
  320. Die gleiche Prozedur, wie fuer F1, muss fuer F2 wiederholt werden. Wieder
  321. werden sie erst nach der Zahl der Units und dann nach der Zahl der Zeilen
  322. gefragt, die diese Units bilden sollen.
  323.  
  324. Nachdem Sie die vier relevanten Parameter
  325.  
  326.         Zahl der F1-Units,
  327.         Zahl der Zeilen in F1,
  328.         Zahl der F2-Units,
  329.         Zahl der Zeilen in F2
  330.  
  331. eingegeben haben, wird das Netzwerk generiert. Schliesslich werden
  332. Sie noch nach einem Namen fuer das Netzwerk und nach einem Dateinamen
  333. gefragt, unter dem es abgespeichert werden soll. Das Dateiformat ist
  334. das Standard-SNNS-Netzwerk-Datei-Format.
  335.  
  336.  
  337. Wenn Sie 2, anstatt 1 oder 3 gewaehlt haben, muessen sie 8 Parameter
  338. angeben, da ein ARTMAP-Netz aus zwei ART1-Netzen besteht. Somit
  339. muessen die vier obigen Parameter fuer beide (ARTa und ARTb) definiert
  340. werden.
  341.  
  342.         Zahl der F1a-Units,
  343.         Zahl der Zeilen in F1a,
  344.         Zahl der F2a-Units,
  345.         Zahl der Zeilen in F2a,
  346.         Zahl der F1b-Units,
  347.         Zahl der Zeilen in F1b,
  348.         Zahl der F2b-Units,
  349.         Zahl der Zeilen in F2b.
  350.  
  351.  
  352. Wenn Sie 99 waehlen, dann verlassen Sie MAKEART und gelangen zurueck zur
  353. Unix-Shell.
  354. ==============================================================================
  355.                    Ende der deutschen Dokumentation
  356. ==============================================================================
  357.  
  358.